home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / language / f2c.zoo / readme.st < prev   
Text File  |  1992-01-26  |  5KB  |  118 lines
  1. This archive contains an Atari ST/TT implementation of a Fortran-to-C 
  2. compiler, developed by AT&T Bell Laboratories and Bellcore (read the file 
  3. NOTICE for legal information). After unpacking, you should have the 
  4. following files:
  5.  
  6. - notice        information about copyright, warranty etc.
  7. - f2c.ttp       the compiler itself
  8. - f2c.1         man page
  9. - f2c.1t        man page for nroff/troff
  10. - f2c.ps        Technical report about f2c
  11. - f2c.h         include file
  12. - f2c.olb       library for 68020/30 machines with 68881 (i.e. Atari TT)
  13. - f2cslow.olb   library for any Atari ST/TT (68000, no FPU)
  14.  
  15. The last three files depend on the C compiler being used to compile the 
  16. C programs produced by f2c. The versions included can be used with 
  17. GNU-C 1.40 and probably also later releases. In the following it is 
  18. assumed that you have a working installation of GNU-C on your system.
  19.  
  20. The combination of f2c and GNU-C can be used as a Fortran compiler that 
  21. compares favourably with commercial compilers, the main disadvantage being 
  22. that source-level debugging is not possible. Even those who regularly use 
  23. another Fortran compiler might be interested in using f2c as a syntax 
  24. checker, since it is very fast and produces better diagnostic output than 
  25. any ST Fortran compiler I know of.
  26. Another obvious application is the conversion of Fortran libraries to C to 
  27. free future programmers from the burdens of Fortran (now you know my 
  28. opinion about Fortran).
  29.  
  30.  
  31. Installation:
  32. -------------
  33.  
  34. - Copy f2c.ttp wherever you keep your executable programs.
  35. - Copy f2c.h wherever GNU-C looks for include files (i.e. the path 
  36.   specified by the environment variable GNUINC).
  37. - Copy f2c.olb and/or f2cslow.olb wherever you keep the GNU-C 
  38.   libraries (i.e. the path specified by the environment variable 
  39.   GNULIB).
  40.  
  41.  
  42. Using f2c:
  43. ----------
  44.  
  45. See f2c.1 and/or f2c.1t for details. f2c.ttp itself does not need any 
  46. other file to operate, the include file and the libraries are needed 
  47. only for subsequent compilation. Please note that f2c options are case 
  48. sensitive; you must run it from a shell that does not convert commandline 
  49. parameters to upper case like the GEM Desktop does. There are three 
  50. differences between the Atari ST implementation and the original Unix 
  51. version described in the documentation:
  52.  
  53. - The Atari ST implementation can only translate one file at a time.
  54. - There is an additional option
  55.         -l logfile
  56.   which causes f2c to write all error messages to the file 'logfile' in 
  57.   addition to showing them on the screen.
  58. - The Fortran programs may have the extensions .f or .for or their 
  59.   upper-case equivalents.
  60.  
  61.  
  62. Translating the generated C programs:
  63. -------------------------------------
  64.  
  65. The programs generated by f2c automatically #include the file f2c.h, which 
  66. contains some compiler-specific definitions. For I/O and some mathematical 
  67. functions, they contain calls to library functions that are contained in 
  68. f2c.olb/f2cslow.olb.
  69. To compile a program foo.c for a machine having a 68020/30 and 68881, use
  70.    gcc -o foo.tos -m68020 -m68881 -D_M68881 foo.c -lf2c 
  71. To compile for a generic ST/TT, i.e. using only 68000 opcodes and software 
  72. floating point routines, use
  73.    gcc -o foo.tos foo.c -lf2c -lpml
  74.  
  75.  
  76. Obtaining the source code:
  77. --------------------------
  78.  
  79. The source code for f2c and the libraries is available from an automatic 
  80. file server at AT&T. For more information, send a message containing the 
  81. single line
  82.    send index
  83. to "netlib@research.att.com".
  84. The library source code is necessary to use f2c with C compilers other 
  85. than GNU-C. Be warned however: porting the libraries to less 
  86. Unix-compatible programming environments will not be easy. If anyone 
  87. manages to implement a support library for Turbo-C/Pure-C, please let me 
  88. know (I gave up after two days; after all, I have other things to do).
  89.  
  90.  
  91. Bugs:
  92. -----
  93.  
  94. I have been using f2c.ttp and f2c.olb for a month now without encountering 
  95. any problems. Since I use a TT, I did only some quick checks on 
  96. f2cslow.olb, but I don't expect any problems, since f2cslow.olb differs 
  97. from f2c.olb only in the compiler options used.
  98. Of course I cannot guarantee anything about this ST/TT implementation; 
  99. nevertheless I would be interested in bug reports, because I have come to 
  100. rely on f2c a lot for my Fortran programming. Bugs not specific to the 
  101. ST/TT implementation should also be reported to the original authors; 
  102. obtain the source code for more information.
  103.  
  104.  
  105. Konrad Hinsen
  106. Institut fuer Theoretische Physik A
  107. RWTH Aachen
  108. Templergraben 55
  109. D-W-5100 Aachen
  110. Germany
  111.  
  112.  
  113. E-Mail addresses:
  114.  
  115.   konrad@thphys.physik.rwth-aachen.de
  116.   cd010hi.dacth11.bitnet
  117.   konrad_hinsen@ac2.maus.de
  118.